What is this?
=============
A local offline webserver with Stack Overflow and practically all of
the Stack Exchange sister sites.
You can search and browse all questions and answers posted up to
2016-09-12. The search is not quite as good as Google at figuring
out what you're looking for, but it can be invaluable when you're
out of internet access.


Why?
====
You could recreate this package by downloading the stackdump viewer and importing the stackexchange data yourself, but it would take a day or
more of work, lots of RAM (> 11GB) and lots of disk space.
I made this for myself, and thought I'd save you that effort.
Stackdump viewer:     bitbucket.org/samuel.lai/stackdump
Stackexchange data:   archive.org/details/stackexchange


Is this legal?
==============
Yes. The data is released by Stack Exchange Inc. under cc-by-sa 3.0
which allows to "remix, transform, and build upon the material".
The viewer program is stackdump by Samuel Lai, and is released under
the MIT License.


How do I use this? What do I need?
==================================
You need Python (2.5 or later, but not 3.0), Java (6 or later) and
55 GB of disk space. The package is a working Mercurial repository
(which also provides a way to check that the code hasn't been
altered). You can update the stackdump viewer with a hg
pull, as well as add and remove sites with manage.sh if
you want more, or to free up space. See the stackdump site for instructions how.

Launching on Linux:
~~~~~~~~~~~~~~~~~~~
Once downloaded and the .7z unpacked, run this in the stackdump
directory:
    ./start_solr.sh &
    ./start_web.sh
to start up a webserver on localhost:8080. To shut it down,
Ctrl+C the two scripts.

Launching on Windows:
~~~~~~~~~~~~~~~~~~~~~
Launch these two scripts from a shell:
    Start-Solr.ps1
    Start-StackdumpWeb.ps1
to start up a webserver on localhost:8080. To shut them down,
Ctrl+C them.
You might need to first turn on script-running for PowerShell (run
Set-ExecutionPolicy RemoteSigned in C:WindowsSysWOW64WindowsPowerShellv1.0powershell.exe started
as Administrator). You might then need to edit Start-Solr.ps1 and
reduce -Xmx2048M to -Xmx1048M (maybe only for 32-bit version of
PowerShell? Not sure). After that, starting Start-Solr.ps1 and
Start-StackdumpWeb.ps1 in two different
C:WindowsSysWOW64WindowsPowerShellv1.0powershell.exes should
put up the webserver.

Other OSes:
~~~~~~~~~~~
Should work if you have Python and Java, but I have not tried
myself